package com.gkzf.ai.framework.tenant.core.aop;

import com.gkzf.ai.framework.tenant.core.context.TenantContextHolder;
import com.gkzf.ai.framework.tenant.core.util.TenantUtils;
import lombok.extern.slf4j.Slf4j;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;

/**
 * 忽略多租户的 Aspect，基于 {@link TenantIgnore} 注解实现，用于一些全局的逻辑。
 * 例如说，一个定时任务，读取所有数据，进行处理。
 * 又例如说，读取所有数据，进行缓存。
 *
 * 整体逻辑的实现，和 {@link TenantUtils#executeIgnore(Runnable)} 需要保持一致
 *
 * @author 国科智飞
 */
@Aspect
@Slf4j
public class TenantIgnoreAspect {

    /**
     * 定义切点，匹配所有被 {@link TenantIgnore} 注解修饰的方法
     * 主要作用：修改上下文中 setIgnore属性 以达到忽略多租户的效果
     * @param joinPoint 允许我们在环绕通知中继续执行目标方法的调用。它提供了一个 proceed() 方法来执行目标方法
     * @param tenantIgnore Spring AOP 会自动将 @TenantIgnore 注解传递给这个参数。在环绕通知中，你可以使用这个参数来访问注解的属性。
     * @return 执行目标方法。joinPoint.proceed() 会继续执行被切面的目标方法，并返回结果
     * @throws Throwable
     */
    @Around("@annotation(tenantIgnore)")
    public Object around(ProceedingJoinPoint joinPoint, TenantIgnore tenantIgnore) throws Throwable {
        Boolean oldIgnore = TenantContextHolder.isIgnore();
        try {
            TenantContextHolder.setIgnore(true);
            // 执行逻辑
            return joinPoint.proceed();
        } finally {
            TenantContextHolder.setIgnore(oldIgnore);
        }
    }

}
